Skip to content

业务平台(station)

/station/role/list 列举角色

method
    get
request
    station_ids         O   json_list   只找这些站点旗下的角色
    permission_ids      O   json_list   只找拥有这些权限的角色
    user_id             O   int         只找这个用户绑定的角色
    name                O   str         根据角色名搜索
    name_is_precision   O   bool        是精准搜索还是模糊搜索
response
    {
        data: {
            roles: [
                {
                    id:
                    name:
                    station_id: "T002"
                    permission_ids: [1, 2, 3]
                }
            ]
        },
        code: 0,
        msg: "OK"
    }

/station/role/get 获取角色详情

method
    get
request
    id
response
    {
        data: {
            id:
            name:
            description:
            station_id:
            permission_ids: [1, 2, 3]
        },
        msg: "OK",
        code: 0
    }

/station/role/create 创建角色

method
    post
response
    {
        data: {
            id: 123
        }
        msg: "OK",
        code: 0
    }

/station/role/update 修改角色

method
    post
response
    {
        data: null
        msg: "OK",
        code: 0
    }

/station/role/delete 删除角色

method
    post
response
    {
        data: null
        msg: "OK",
        code: 0
    }

/station/user/list 列举用户

method
    get
request
    station_ids
    role_ids
    search_text     根据 username 或者 name 模糊搜索
    permission_ids  只找拥有这些权限的用户
response
    {
        data: {
            users: [
                {
                    id:
                    name:
                    description:
                    create_date:
                    station_id:
                    role_ids:
                }
                ...
            ]
        }
        msg: "OK",
        code: 0
    }

/station/user/get 获取用户详情

request
    id
    username
response
    {
        data: {
            id:
            username:
            name:
            station_id:
            description:
            is_admin
            phone
            email
            card_id
            is_valid
            card_emblem_img_url
            card_photo_img_url
            role_ids
        },
        msg: "OK",
        code: 0
    }

/station/user/create 创建用户

method
    post
request

response
    {
        data: {
            id: 1234
        }
        msg: "OK",
        code: 0
    }

/station/user/update 修改用户

method
    post
response
    {
        data: null
        msg: "OK",
        code: 0
    }

/station/user/delete 删除用户

method
    post
request
    id  M   id
response
    {
        data: null
        msg: "OK",
        code: 0
    }

/station/permission_class/tree 列举权限分类

method
    post
request
    level2_ids  只寻找这些二级权限拥有的权限分类
response
    {
        data: {
            permission_classes: [
                {
                    id: 1                   // level 1 id
                    name: "abcd"            // level 1 name
                    content: [
                        {
                            id: 2           // level 2 id
                            name: "abcd"    // level 2 name
                        }
                        ...
                    ]
                }
                ...
            ]
        },
        code: 0,
        msg: "OK"
    }

/station/permission/list 列举权限

request
    station_ids 只找这些站点拥有的权限
    role_id     只找这个角色拥有的权限
response
    {
        data: {
            permissions: [
                {
                    id: 123
                    name: "中国语字符串"
                    codename: "english_codename"
                    level2_id: 234  // 二级权限分类的 id
                    role_ids: [345, ...]
                },
                ...
            ]
        },
        code: 0,
        msg: "OK"
    }

/station/permission/change_role 修改权限和角色的关系

request
    id          M   str     权限 id
    role_ids    M   str     更新「拥有这个权限的」角色列表
    station_id  O   bool
    partner_id  O   bool
response
    { data: null, code: 0, msg: "OK" }
logic
    station_id 和 partner_id 只能取一个
    TODO 界面上,按权限查看,无法区分不同站点的角色

信息平台(management)

/ma/role/list 列举角色

request
    partner_id      O   只找这个旗下的角色
    permission_ids  O   只找拥有这些权限的角色
    user_id         O   只找这个用户绑定的角色
    search_text     O   根据角色名模糊搜索
    name            O   根据角色名精准搜索
response
    {
        data: {
            roles: [
                {
                    id:
                    name:
                    description:
                    create_date:
                    partner_id: 123
                    permission_ids: [1, 2, 3]
                }
            ]
        },
        code: 0,
        msg: "OK"
    }

/ma/role/get 获取角色详情

request
    id
response
    {
        data: {
            id:
            name:
            description:
            partner_id:
            permission_ids:
        },
        msg: "OK",
        code: 0
    }

/ma/role/create 创建角色

/ma/role/update 修改角色

/ma/role/delete 删除角色

/ma/user/list 列举用户

request
    partner_id      只找这个加盟商旗下的用户
    role_ids        只找绑定这些角色的用户
    search_text     根据 username 或者 name 模糊搜索
    permission_ids  只找拥有这些权限的用户
response
    {
        data: {
            users: [
                id:
                name:
                description:
                create_date:
                partner_id:
                role_ids:
                visible_station_ids:
            ]
        }
        msg: "OK",
        code: 0
    }

/ma/user/get 获取用户详情

request
    id
response
    {
        data: {
            id:
            username:
            name:
            partner_id:
            description:
            is_admin
            phone
            email
            card_id
            is_valid
            card_1_img_url
            card_2_img_url
            role_ids
        },
        msg: "OK",
        code: 0
    }

/ma/user/create 创建用户

/ma/user/update 修改用户

/ma/user/delete 删除用户

/ma/permission_class/tree 列举权限分类

request
    level2_ids  只寻找这些二级权限拥有的权限分类
response
    {
        data: {
            permission_classes: [
                {
                    id: 1                   // level 1 id
                    name: "abcd"            // level 1 name
                    content: [
                        {
                            id: 2           // level 2 id
                            name: "abcd"    // level 2 name
                        }
                        ...
                    ]
                }
                ...
            ]
        },
        code: 0,
        msg: "OK"
    }

/ma/permission/list 列举权限

request
    partner_id  只找这个加盟商拥有的权限
    role_id     只找这个角色拥有的权限
response
    {
        data: {
            permissions: [
                {
                    id:
                    name:
                    level2_id:  // 二级权限分类的 id
                    role_ids:
                },
                ...
            ]
        },
        code: 0,
        msg: "OK"
    }

/ma/permission/change_role 修改权限和角色的关系

request
    id          M   str     权限 id
    role_ids    M   str     更新「拥有这个权限的」角色列表
    station_id  O   bool
    partner_id  O   bool
response
    { data: null, code: 0, msg: "OK" }
logic
    station_id 和 partner_id 只能取一个
    TODO 界面上,按权限查看,无法区分不同站点的角色